home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / database / convr409.zip / BRUCE409.DOC next >
Text File  |  1994-09-23  |  29KB  |  602 lines

  1. BRUCE409.DOC
  2. 09/23/94
  3.  
  4. --------------------------------------------------------------------------------
  5.  
  6. Contact information:
  7.  
  8. For the following routines:  AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL,
  9. FILL, FIXTEXT, FORTUNE, MULTICOL, READINIT, or READMAKE-created files:
  10.  
  11.                 Bruce Guthrie
  12.                 Wayne Software
  13.                 113 Sheffield St.
  14.                 Silver Spring, MD 20910
  15.  
  16.                 fax: (301) 588-8986
  17.  
  18. For the following routines:  CHANGE, CONVERT, FILUPDAT, and READ:
  19.  
  20.                 Bruce Guthrie
  21.                 Room H-4885
  22.                 U.S. Dept of Commerce/ESA/OBA
  23.                 Washington, DC 20230
  24.  
  25.                 fax: (202) 482-2164
  26.  
  27.                 E-Mail: bgu@cu.nih.gov
  28.  
  29. Foreign users:  Please provide an Internet-reachable e-mail address in all
  30. correspondence if you have any hope of getting a reply!  Internet e-mail is the
  31. preferred method of contact for all other users as well.  Remember, CompuServe
  32. and Prodigy are now Internet accessible.
  33.  
  34. The current "production" releases of these programs are directly posted by
  35. the author on the Simtel ftp site at oak.oakland.edu.  More information about
  36. this is provided later.
  37.  
  38. --------------------------------------------------------------------------------
  39.  
  40. Introduction:
  41.  
  42. This documentation provides some overview information on a number of utilities
  43. that have been posted by Wayne Software.  All programs described herein were
  44. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  45. Others were written for the U.S. Department of Commerce.  All are free for use
  46. provided relevant documentation is kept with the programs, no changes are made
  47. to the programs or documentation, and they are not bundled with commercial
  48. programs or charged for separately.
  49.  
  50.  
  51. CHANGE, CONVERT, FILUPDAT, and READ are excluded from the commercial
  52. packaging restriction.  These programs are owned by the U.S.  Department of
  53. Commerce and may be re-distributed without restriction.
  54.  
  55. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, FILL,
  56. FIXTEXT, FORTUNE, MULTICOL, READINIT, or READMAKE-created files in commercial
  57. packages other than shareware/freeware collections must pay a $50 registration
  58. fee to "Wayne Software" at the following address.  READMAKE-created files are
  59. also subject to this limitation.  I don't expect to make any money from these
  60. utilities but I don't want others to sell them instead.
  61.  
  62. The utilities are uploaded with a ZIP name that includes the year and month of
  63. the release.  These names are:
  64.  
  65.          ZIP file         Executables included
  66.  
  67.          AVymm.ZIP        AV.EXE
  68.          BFINDymm.ZIP     BFIND.EXE, CONFIGWS.EXE
  69.          CHANGymm.ZIP     CHANGE.EXE
  70.          CONVRymm.ZIP     CONVERT.EXE
  71.          COPSymm.ZIP      COPSINCE.EXE
  72.          DATESymm.ZIP     DATES.EXE
  73.          DIRCOymm.ZIP     DIRCOMP.EXE
  74.          DIRTOymm.ZIP     DIRTOTAL.EXE
  75.          FILLymm.ZIP      FILL.EXE
  76.          FILUPymm.ZIP     FILUPDAT.EXE
  77.          FIXTXymm.ZIP     FIXTEXT.EXE
  78.          FORTNymm.ZIP     FORTUNE.EXE
  79.          MULCOymm.ZIP     MULTICOL.EXE
  80.          READymm.ZIP      READ.EXE, READINIT.EXE, READMAKE.EXE
  81.  
  82.  
  83. This collection of utilities were compiled using Microsoft's Visual BASIC for
  84. DOS 1.0 compiler.  In each case, Thomas G. Hanlin III's excellent PBClone
  85. routines, release 2.2, provided additional functionality.  Each of the utilities
  86. are separately described in a like-named *.DOC file.  This documentation
  87. (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves
  88. to summarize what the various utilities consist of.
  89.  
  90. Several of the routines have defaults that can be changed by the program
  91. CONFIGWS.EXE which is currently only included in the BFIND compressed file
  92. although it works with any of the routines that support it.  The newer technique
  93. being incorporated in the routines, however, is an inifile (like AV.INI) which
  94. lets you set any defaults you want.  This is described in the appropriate
  95. documentation.
  96.  
  97. Wayne Software also writes programs, batch files, and sets up menu systems for
  98. people on a for-fee basis.  If you desire this service, contact Wayne Software
  99. at the address specified above.
  100.  
  101.  
  102. --------------------------------------------------------------------------------
  103.  
  104. Summary of programs:
  105.  
  106. A summary of each routine follows.  See the associated *.DOC files for fuller
  107. explanations:
  108.  
  109. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  110. etc) and lets you sort as desired.  Also allows resetting of the file date based
  111. on the archive's contents.  Syntax:
  112.  
  113.     AV filespec [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /I ]
  114.       [ /Q ] [ /? ] [ > filename ]
  115.  
  116. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  117. one string AND another one, or any line with one string OR another.  The syntax
  118. shown below is incomplete since "search" allows a lot of choices and allows the
  119. use of parens and Boolean operators.  Syntax:
  120.  
  121.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  122.       [ /-HEADER | /HEADER ] [ /Iinitfile | /INULL ]
  123.       { search } infile [ /? | /?&H ] [ >filename ]
  124.  
  125. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  126. type (e.g.  binary or text) and are processed quickly.  Up to thirty change
  127. commands can be processed in a single pass.  Also provides ability to remove
  128. trailing spaces from text files.  Syntax:
  129.  
  130.     CHANGE infile [ /Cctlfile | /FROM string /TO string [ /IN search ] ]
  131.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  132.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  133.       [ /Iinitfile ] [ /Fflagfile ] [ /Ttempfile ] [ /TRIM | /-TRIM ]
  134.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? | /?&H ]
  135.  
  136. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  137. Is included in the ZIP file with whatever routines it supports.  Syntax:
  138.  
  139.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  140.  
  141. CONVERT.EXE:  Converts data between data formats:  FROM dBase, ASCII-delimited
  142. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  143. ASCII-delimited, dBase, and fixed field.  Syntax:
  144.  
  145.     CONVERT infile [ outfile [ deffile ] ]
  146.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  147.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ] [ /Iinitfile | /-I ]
  148.       [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED | /-DELETED ]
  149.       [ /TO FIXED | /TO ASCII | /TO WKS | /TO DBF ] [ /HEADER | /-HEADER ]
  150.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  151.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  152.       [ /SKIP | /MISSING | /ABORT ] [ /NULLS | /-NULLS ] [ /Q ] [ /? | /?&H ]
  153.  
  154. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  155. making sure you have a back-up of stuff and also to copy updated programs to
  156. another place.  Lets you define your own groupings of files if desired.  Syntax:
  157.  
  158.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  159.       [ mm/dd/yy | -n | /COPY mm/dd/yy | /COPY -n ] [ /ALL | /TEXT | /filetype ]
  160.       [ /Iinitfile | /-I ] [ /DEF filetype=spec [ spec ]... ]
  161.       [ /REPLACE | /-REPLACE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  162.  
  163. DATES.EXE:  Simple program that warns you in advance when an event like a
  164. birthday, anniversary, or holiday is coming up.  The idea is to give you advance
  165. warning so you can send a card or get out of town in time.  Syntax:
  166.  
  167.     DATES [ date_file [...] ] [ /Ddays ] [ /-AGE | /AGE ] [ /COLOR=nnn nnn nnn ]
  168.       [ /CLS | /-CLS ] [ /Q | /-Q ] [ /Iinitfile | /-I ] [ /R ]
  169.       [ /DAY | /-DAY ] [ /MONO | /COLOR ] [ /SKIP | /-SKIP ]
  170.       [ /DATE=format ] [ /? ] [ > filename ]
  171.  
  172. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  173. delete extra files in the destination subdirectory, copy hidden and system
  174. files, and prepare a report showing inconsistencies.  Syntax:
  175.  
  176.     DIRCOMP directory1 directory2 [ /S ] [ /CREATE ]
  177.       [ /UPDATE ] [ /KILL ] [ /CLONE ] [ /MOVE ] [ /ATTR=[H][S][R] ] [ /NET ]
  178.       [ /Frptfile | /-F ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  179.       [ /ALL ] [ /Td: ] [ /Q ] [ /? ]
  180.  
  181. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  182. some restriction requests (show only files with date greater than a certain
  183. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  184. great program but it doesn't work on network or CD-ROM discs) in some ways but
  185. presents a more formal report.  Also allows you to look for duplicate file names
  186. and search by attributes or dates.  Syntax:
  187.  
  188.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  189.         [ drive: ] ... [drive:]\path[\filespec] ]
  190.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  191.       [ /NL ] [ /-HEADERS ] [ /-FOOTERS ] [ /CLUSTERS | /-CLUSTERS ]
  192.       [ /S { GT | GE | LT | LE | EQ | NE } value ]
  193.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ] [ /ATTR=attr ]
  194.       [ /Frptfile ] [ /Z | /-Z ] [ /Z2 | /-Z2 ] [ /Iinitfile | /-I ]
  195.       [ /SUB1 | /-SUB1 ] [ /SUB2 | /-SUB2 ] [ /+DIR | /-DIR ] [ /n ]
  196.       [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Td: ] [ /Q ] [ /? ]
  197.  
  198. FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  199. biggest files first and skipping those that won't fit.  Also provides option of
  200. splitting large files up, labeling output disks, and creating a status report.
  201. Syntax:
  202.  
  203.     FILL [ source-filespec ] [ [ /TO ] dest-drive: | [ /TO ] dest-drive:\path\ ]
  204.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ] [ /Iinitfile | /-I ]
  205.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  206.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  207.       [ /SPLIT ] [ /LABEL=label [ /START=n ] ] [ /Fstatfile [ /S+ | /S- | S* ]
  208.       [ /CONTINUAL ] [ /BEEP | /-BEEP ] [ /FAKE ] [ /Q ] [ /? ]
  209.  
  210. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  211. against those in another path and copies those that have been updated.  Similar
  212. to DOS' REPLACE command but works from a stored list of files and can handle any
  213. number of directories.  Syntax:
  214.  
  215.     FILUPDAT ctlfile
  216.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  217.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  218.  
  219. FIXTEXT.EXE:  Program which applies a user-definable character-translation table
  220. to a text file.  Can allow you to convert graphics characters to their ASCII
  221. equivalents, lowercase letters to uppercase letter, etc.  Can also be used to
  222. translate DOS text files to Mac or Unix text files and vice versa.  Can also
  223. expand tabs, remove trailing spaces, and remove backspaces.  Syntax:
  224.  
  225.     FIXTEXT infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  226.       /REPLACE } [ /Iinitfile | /-I ] [ /TEXT | /-TEXT ] [ /EJECT=str ]
  227.       [ /CRLF | /CR | /LF | /-LINE ] [ /TO CRLF | /TO CR | /TO LF | /TO -LINE ]
  228.       [ /WIDTH=n ] [ /Frptfile | /-F ] [ /Q ] [ /? | /?&H ]
  229.  
  230. FORTUNE.EXE:  Program which adds some fine-tuning to the DOS FOR command.
  231. Among other things, this lets you distinguish file name roots from their
  232. extensions as well as increment file names by specified values.  Syntax:
  233.  
  234.     FORTUNE { IN (set) | IN filespec | /IN (set) | /IN filespec | filespec }
  235.       [ /AS filename ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  236.       [ /VAR=char ] [ /DELIM=chars ] [ /+n | /-n ] [ /S ] [ /Xfilespec ] ...
  237.       [ /ECHO | /-ECHO ] [ /ABEND | /-ABEND ] [ /PAUSE | /-PAUSE ]
  238.       [ /Iinitfile | /-I ] [ /? ] { DO cmd | /DO cmd | cmd }
  239.  
  240. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  241. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Can
  242. also be used to add headers and footers to standard one-column text.  Syntax:
  243.  
  244.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  245.       [ /DELIM="string" ] [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  246.       [ /COLUMNS=n ] [ /-WRAP | /WRAP [ /INDENT=n ] | /REFLOW ]
  247.       [ /Iinitfile | /-I ] [ /SETUP="string" ] [ /RESET="string" ]
  248.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  249.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  250.       [ /-TITLE ] [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  251.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  252.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  253.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /TALLY ]
  254.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  255.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  256.       [ /PRINT={ col_spec | var_spec } ] [ /? | /?&H ]
  257.  
  258. READ.EXE:  Text file browser.  Supports marking, copying text, reading Unix
  259. and Mac text files, etc.  Only works with files of 16,000 lines or less (maybe
  260. 800,000 bytes).  Other text viewers are out there.  This one has some advantage
  261. because it's free!  Syntax:
  262.  
  263.     READ [ filespec | @flistfile ] [ /TITLE="title" ] [ /DATE=NONE ]
  264.       [ /line ] [ /MONO | /COLOR ] [ /EGA | /VGA ] [ /-MOUSE ] [ /DOS | /-DOS ]
  265.       [ /Iinitfile | /-I ] [ /Q ] [ /PORT=port ] [ /INITT=string ]
  266.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  267.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  268.  
  269. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  270. READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE.
  271. Syntax:
  272.  
  273.     READINIT [ /MONO | /COLOR ]
  274.       [ Iinitfile | /-I ] [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ]
  275.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  276.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  277.  
  278. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  279. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  280.  
  281.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  282.       [ /DATE=FILE | /DATE=TODAY | /DATE=NONE ] [ /TITLE="text" ] [ /? ]
  283.  
  284.  
  285. -------------------------------------------------------------------------------
  286.  
  287. Where to find them on the Internet:
  288.  
  289. In general, I no longer copy utilities to regular computer bulletin boards.
  290. While users are encouraged to do so, it's a lot easier for me to post them using
  291. ftp on the Internet.  I post them directly on the Simtel archives at
  292. oak.oakland.edu and they are available there using anonymous ftp.  Subdirectory
  293. names have been undergoing some revisions out there of late but the directories
  294. should stay roughly the same.  The version numbers (indicated by the three
  295. digits before the .zip extension) may change as they reflect the last release
  296. date of the program ("403" is March 1994).  The versions listed below are
  297. current as of September 1994.
  298.  
  299. Off SimTel/msdos/, look for:
  300.  
  301.      arcutil/av409.zip        Archive view: Free ZIP etc directory viewer
  302.      textutil/bfind409.zip    Boolean FIND command (BFIND BEGIN & END)
  303.      textutil/chang409.zip    Change strings in text files
  304.      spredsht/convr409.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  305.      dirutil/cops407.zip      Copies files modified since given date
  306.      batutil/dates409.zip     Warns you in advance of birthdays etc
  307.      dirutil/dirco403.zip     Updates files based on source directory
  308.      dirutil/dirto409.zip     Directory lister and totaller
  309.      diskutil/fill408.zip     Stuffs as many files as possible on disk
  310.      dirutil/filup401.zip     Copy updated files based on a control list
  311.      textutil/fixtx407.zip    Translate text file characters en masse
  312.      batutil/fortn409.zip     Fine-tunes DOS FOR command w/options
  313.      textutil/mulco407.zip    Multicolumn text with headers, dBase supported
  314.      textutil/read409.zip     Free viewer, also make any text self-viewing
  315.  
  316. Note that the versions above are subject to change.  The last three digits
  317. before ".zip" indicate the last digit of the year and the two digit month.
  318. Depending on how often I've updated things, you might find something like a 410
  319. version instead of 409 when you go to look.
  320.  
  321. If you can't get all of the utilities from your own sources, send $10 to the
  322. address above and I'll send you everything.  Please specify disk size/density.
  323.  
  324. Another Wayne Software product, called The DEMO System, is released as a
  325. shareware program.  The DEMO System is a unique system designed to create
  326. text-screen demos, tutorials, help screens, etc.  Look for the file
  327. DEMOSymm.ZIP.  On oak.oakland.edu, it's in SimTel/msdos/ as:
  328.  
  329.      screen/demos401.zip      Create tutorials, demos, menu systems, etc.
  330.  
  331.  
  332. --------------------------------------------------------------------------------
  333.  
  334. Beta-zoids...  Thanks to:
  335.  
  336. Beta testers are always desired for these utilities.  You don't get a damned
  337. thing out of being one (which is about what I get for writing them) but it
  338. doesn't cost you much besides an hour or two and lets you have more of an impact
  339. on the future courses of the routines.  In order to be a beta tester, you have
  340. to be able to receive uuencoded files via e-mail (so forget CompuServe and
  341. Prodigy people; sorry).  If you're interested, drop a message to me at
  342. bgu@cu.nih.gov and tell me which routine(s) you're interested in being on the
  343. list for.
  344.  
  345. Existing routines have gotten suggestions, comments, and even complements from
  346. all over the world (definitely something I *love* about the Internet).  No money
  347. of course but the ego's a powerful thing to feed!  (The flamers of course should
  348. be burned at the stake or maybe start writing their own programs instead of
  349. criticizing other people's.) Thanks to (and sorry for screwing up some of these
  350. addresses and for forgetting to put in others)...
  351.  
  352. CHANGE:         mcardleb@cosy.uml.edu
  353. CHANGE:         rainer.wuerlaender@statistik.uni-muenchen.d400.de
  354. CHANGE:         rallings@gidday@enet.dec.com
  355. CHANGE:         zazovsky@scrsul.sinet.slb.com
  356. CONVERT:        haapanen@niini.metla.fi
  357. CONVERT:        leono@uiuc.edu
  358. CONVERT:        rausch@rz.uni-frankfurt.de
  359. CONVERT:        rehmet@studserv.zdv.uni-tuebingen.de
  360. DATES:          fmaxwell@unixg.ubc.ca
  361. DATES:          hans.schrader@geol.uib.no
  362. DATES:          matt.needham@loebbs.com
  363. DATES:          paul.simmonds@jet.uk
  364. DIRCOMP:        mcclell@julian.uwo.ca
  365. DIRCOMP:        ornstedt@it.kth.se
  366. DIRTOTAL:       longr@qus102.qld.tne.oz.au
  367. DIRTOTAL:       saracen@cix.compulink.co.uk
  368. DIRTOTAL:       westg@rintintin.colorado.edu
  369. FILL:           beezer@cc.utah.edu
  370. FILL:           dashiell@nadc.nadc.navy.mil
  371. FILL:           djtooley@undergrad.math.waterloo.ca
  372. FORTUNE:        thth@forsci.ualberta.ca
  373. ISAMFIND:       ns_john@seqeb.gov.au
  374. PAGINATE:       ns_john@seqeb.gov.au
  375. PAGINATE:       stewartt@ucs.orst.edu
  376. READ:           ferch@cca.ubc.ca
  377. READ:           mossako@asterix.uni-muenster.de
  378.  
  379.  
  380.  
  381. Need beta tester volunteers:
  382.  
  383. I'm currently working on two programs that I need some beta testers for.  If
  384. you're interested (and you can receive files via Internet e-mail), please
  385. contact me at bgu@cu.nih.gov.
  386.  
  387. ISAMMAKE/ISAMFIND:  Index the words in your text files and then search for the
  388. files based on these words.  For example, index all of the FAQ files you have
  389. and then find the files that have "BUGS BUNNY" in them.  Useful for help desks
  390. and the like.
  391.  
  392. PAGINATE:  Program that lets you imbed marker commands in a text file and do
  393. things like align and justify text.  Adds headers and footers.  Also lets you
  394. imbed ASCII-delimited text and references to dBase files and incorporate them
  395. into your text.  Also lets you generate indexes.  This program will replace
  396. MULTICOL which does some of these features but isn't anywhere as flexible.
  397.  
  398.  
  399. --------------------------------------------------------------------------------
  400.  
  401. Revision history:
  402.  
  403. Detailed revision history is only maintained for the last two or three releases.
  404. After that, you get the major revision summaries only.  After six months or so,
  405. you get only earth-shattering stuff and after a year you get nothing.  No one
  406. reads this junk anyway, right?  Programmer types like to put in it in just to
  407. justify what they've been doing over the last couple of years.
  408.  
  409. --------------
  410. Release 94/09:
  411.  
  412. All programs:  Fixed up a bug which usually ignored /INULL.  Sigh.  Also added
  413. stubs in VisualBASIC which shrank the size of the EXE's by a fair amount.
  414.  
  415. AV:  The PBClone libraries that I use were updated to support current ARJ
  416. formats and PKZIP 2.0 self-extracting archives so AV includes these too now.
  417.  
  418. BFIND:  Added the ability to include hexadecimal codes in the find string.
  419. For example, "BFIND \034\034 APPLES.TXT" to find double quotes.  Added /?&H
  420. parm to show the hexadecimal codes.
  421.  
  422. CONVERT:  Fixed a problem with ASCII-delimited input files that didn't have
  423. any quoted strings in them; program thought it was a fixed-field file in that
  424. case.  /FROM DBF files weren't producing /OUTDEF files; fixed that.  Added
  425. /NULLS and /-NULLS options.  Added /-DELETED option.  dBase input files without
  426. INDEF's were ignoring the default decimal place settings; fixed that.  Fixed
  427. a problem with dBase field names if you took an ASCII-delimited or fixed-field
  428. file created by CONVERT and tried to reconvert it back to dBase.
  429.  
  430. DATES:  Added /DATE=form option to let you specify different formats for the
  431. input dates.  For example, /DATE=dd/mm/yy.  If standard delimiters are used
  432. between fields (e.g. "/", "-", or "."), the program allows variable-length
  433. dates (such as 9/5/94 as well as 09/05/94).  Also added ability to read months
  434. in JAN, FEB, MAR, etc form.
  435.  
  436. CHANGE:  Expanded number of changes allowed in the control file to be 30 instead
  437. of 25.  Also changed the way that some of the output appears if redirection is
  438. used.  Wiped out the ability to specify the control file without using /C (the
  439. other way seldom worked anyway).
  440.  
  441. DIRTOTAL:  The PBClone libraries that I use were updated to support current ARJ
  442. formats and PKZIP 2.0 self-extracting archives; DIRTOTAL supports as well.
  443. Added the /Z2 and /-Z2 options to tell the program to check for self-extracting
  444. files in EXE's.
  445.  
  446. FORTUNE:  Parameters weren't being correctly read after I added the init files.
  447. Fixed that.
  448.  
  449. READ:  Added /Q option to suppress the messages about the initfile.  All other
  450. programs that support initfiles and the option /Q now handle it the same way.
  451. Changed the program so it tries to display something as soon as it has enough
  452. of the file read into memory.  This makes the file appear to load quicker.  Note
  453. that the screen will redraw itself after it finishes everything.  Added /VGA and
  454. /EGA options (which are synonymous).
  455.  
  456. --------------
  457. Release 94/08:
  458.  
  459. BFIND:  Added /Iinitfile and /-I parms.  Unlike the other routines, I've
  460. temporarily kept CONFIGWS.* in with the distribution package for anyone who
  461. wants to keep it around before I delete it.  It will be deleted the next time
  462. around.  Also changed the program to invoke /-P (no pause) if redirection is
  463. used.
  464.  
  465. CHANGE:  More bugs; still didn't work if an output file wasn't specified.
  466.  
  467. DATES:  Added /R option to set DOS return code based on number of items
  468. found.  Allowed for up to 10 input files.  Added /DAY option to show the day
  469. of the week.  Switched /A to /AGE and /-A to /-AGE although the old versions
  470. still work.  Also shifted to emphasize "/Ddays" over "days".  Added ability to
  471. specify lines beginning with asterisks that will print verbatim.  Added /MONO,
  472. /COLOR, /SKIP, and /-SKIP options.
  473.  
  474. FILL:  Added /FAKE option to pretend you're copying files but not really let
  475. you do anything.  Fixed a bug which didn't recalculate space when formatting
  476. was done.
  477.  
  478. FORTUNE:  Added /Iinitfile and /-I parms.  Dropped distribution of CONFIGWS.*
  479. with the program (since *.INI should be able to handle everything).  Added
  480. return codes.
  481.  
  482. --------------
  483. Release 94/07:
  484.  
  485. AV, CHANGE, CONVERT, and DIRTOTAL:  Added /Iinitfile and /-I parms.  Dropped
  486. distribution of CONFIGWS.* with the program (since *.INI should be able to
  487. handle everything).
  488.  
  489. AV:  Added mouse support for paging.
  490.  
  491. CHANGE:  Some times screwed up if an output file wasn't specified.
  492.  
  493. CONFIGWS:  As you can guess, the main focus of everything in this release has
  494. been to allow you to use an *.INI file instead of the CONFIGWS routine to
  495. establish default settings for many of the routines.  As a result, CONFIGWS is
  496. no longer being distributed with most of the routines.  If you want to use
  497. CONFIGWS to hard-code the defaults, you should be able to use an older version
  498. of the program; if it's incompatible with the EXE you're trying to modify,
  499. you'll be told immediately.  I currently document CONFIGWS settings in each of
  500. the routines that are affected (something that wasn't done before this release)
  501. but those references will be dropped some time in 1995.  In that case, older
  502. versions of CONFIGWS should still work but it won't be documented.
  503.  
  504. CONVERT and MULTICOL:  Writing a new program called PAGINATE caused some
  505. rethinking about field-definition files.  Switched parameters from /DEF, /-DEF,
  506. and /DEF=filename to /INDEF=filename, /-INDEF, /OUTDEF=filename, and /-OUTDEF.
  507. For compatibility purposes, temporarily maintained most of the old syntax but
  508. some of the meanings may change.  Also changed the default value of INMISSC from
  509.  to NULL.
  510.  
  511. COPSINCE:  Added /Iinitfile parm.  Dropped distribution of CONFIGWS.* with the
  512. program (since the COPSINCE.INI file should be able to handle everything).
  513. Switched it so the program searches for COPSINCE.INI along your DOS path.
  514.  
  515. DATES:  Forgot to include the sample dates file.  Sigh.  Changed the program to
  516. search for DATES.TXT along your path; previously had to be in your default
  517. subdirectory.  Added /-I, /CLS, /-CLS, /COLOR=nnn nnn nnn parms, /Q, and /-Q
  518. parameters.  /Q invoked automatically if redirection used.
  519.  
  520. FIXTEXT:  Allowed more options in the initfile.  Dropped distribution of
  521. CONFIGWS.* with the program (since FIXTEXT.INI should be able to handle
  522. everything).  Switched it so the program searches for FIXTEXT.INI along your DOS
  523. path.
  524.  
  525. MULTICOL:  Switched from the /Cctlfile to the more generic /Iinitfile.  Added
  526. the /-I option.  Dropped distribution of CONFIGWS.* with the program (since
  527. *.INI should be able to handle everything).
  528.  
  529. READ:  Made READ's use of hexadecimal codes (previously /nnn) consistent with
  530. the other Wayne Software routines (use \nnn or &Hxx instead).  Converted the
  531. READ.INI file to the newer initfile system.  As a result, the older format of
  532. the READ.INI files will not work.  The two changes you'll have to make if you
  533. want to manually modify the READ.INI file:  (1) add a "/" in front of each of
  534. the commands (e.g.  "/PORT=port" instead of "PORT=port" and (2) switch all /nnn
  535. references for hexadecimal codes to \nnn.  Dropped documentation of the /Pport
  536. option (which is still supported).  Added as command line parameters all of the
  537. options used in READ.INI (/PORT=port, /INITT=string, /INITW=string,
  538. /AFTERP=string, /AFTERF=string, and /COLOR=nnn nnn nnn nnn).  Dropped
  539. distribution of CONFIGWS.* with the program (since *.INI should be able to
  540. handle everything).  The searching pattern for the READ.INI subdirectory is
  541. different now.
  542.  
  543. READINIT:  Modified to support the new hexadecimal referencing (switched /nnn to
  544. \nnn and &Hxx) and required "/" in front of the command lines.  Added as command
  545. line parameters all of the options used in READ.INI (/PORT=port, /INITT=string,
  546. /INITW=string, /AFTERP=string, /AFTERF=string, and /COLOR=nnn nnn nnn nnn).  The
  547. searching pattern for the READ.INI subdirectory is different now.
  548.  
  549. -------------- (kind of terse)
  550. Release 94/06:
  551.  
  552.   BFIND:  Internally, command accepted parameters passed in as either "/" or "-"
  553.   (e.g.  "/V" was the same as "-V").  This caused some searches to fail so
  554.   dropped it.
  555.  
  556.   DATES:  New program.
  557.  
  558.   FIXCHARS:  Dropped since FIXTEXT replaced.
  559.  
  560. Release 94/04:
  561.  
  562.   AV:  Stopped /Q option from changing file date/time for non-archive files.
  563.  
  564.   FORTUNE:  Added automatic detection of 4DOS users.  Made use of "/IN" and
  565.   "/DO" largely optional.
  566.  
  567.   NETSORT:  Dropped.
  568.  
  569. Release 94/03:
  570.  
  571.   AV:  Removed system limits on number of members (and sped things up a bit) if
  572.   you specify the /Q (no display, fix date/time stamp).
  573.  
  574.   DIRCOMP:  Added /MOVE parameter which lets you do pruning and grafting
  575.   operations.
  576.  
  577. Release 94/02:
  578.  
  579.   FILL:  Added reformatting options if /WIPE was specified for the output disk.
  580.  
  581.   FORTUNE:  New program.
  582.  
  583. -------------- (real terse)
  584. Release 94/01:
  585.   New:  COPSINCE and FIXTEXT.
  586.   READ:  Added ability to handle Mac and Unix text files.
  587.  
  588. Release 93/10:
  589.   Dropped:  CONCAT and READWK
  590.  
  591. Release 93/05:
  592.   New:  NETSORT and READWK.
  593.   Dropped:  ADD and TAKE1ST.
  594.  
  595. Release 93/03:
  596.   New:  AV and READINIT.
  597.  
  598. Release 93/01:
  599.   First release posted on SIMTEL (Internet).
  600.   New:  The DEMO System (shareware and not part of normal package).
  601.  
  602.